GetEntry

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODObjectNameSpace

GetEntry
The GetEntry method searches for an entry with the specified key and, if it exists, gets a reference to the object associated with that key.
ODBoolean GetEntry (in ODISOStr key,
                    out ODObject object);
key
The key to search for in this object name space.
object
If the entry is found, a reference to the object corresponding to the specified key, otherwise kODNULL.
return value
kODTrue if the entry was found, otherwise kODFalse.

DISCUSSION
If the specified key is found, this method sets the object output parameter to a reference to the corresponding object. If the specified key is not found in this name space, this method searches the parent name space. Searches proceed from each object name space to its parent until one of the following happens: the entry is found, there is no parent name space to search, or the parent name space is a value name space instead of an object name space.
If the object corresponding to the specified key is a reference-counted object, this method does not increment the object's reference count. For that reason, if you cache that object, you should call its Acquire method to increment its reference count and then call its Release method when you are finished using it.

SEE ALSO
The ODISOStr type (page 875).
The ODNameSpace::Exists method (page 429).
The ODObjectNameSpace::Register method (page 452).